home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / cdisk12.arc / CATDISK.DOC < prev    next >
Encoding:
Text File  |  1986-10-17  |  10.8 KB  |  347 lines
  1.  
  2.  
  3.  
  4.  
  5.                                    CATDISK
  6.                            A Diskette Catalog Program
  7.                         Version 1.20  -- 16 October 1986
  8.  
  9.                                      by
  10.  
  11.                                  Rick Hillier
  12.  
  13.  
  14.  
  15.                                  INTRODUCTION
  16.  
  17.  
  18. Overheard:  "I know I have that file in an archive on a diskette SOMEWHERE,
  19.              but which disk is it on?"
  20.  
  21. Sound familiar?  Many people that I know are in this predicament, especially
  22. those with floppy-based systems.
  23.  
  24. Enter CATDISK, the diskette cataloging system.  CATDISK can organize a "Super
  25. Directory" of all your diskette files in alphabetical order and tell you what
  26. diskette(s) they are on in a single glance.  For those who use the ARC utility
  27. from System Enhancement Associates (highly recommended!), there is an added
  28. bonus.  CATDISK can also read .ARC files and include the individual files from
  29. the archive in your catalog along with the archive name from which they came!
  30.  
  31. CATDISK has been placed in the public domain by the author, Rick Hillier, and
  32. a $15 registration fee is requested if you use the program and find it to be
  33. beneficial.  In any case, please feel free to copy and share this program with
  34. others.  I will only support those who contribute toward the development of
  35. this SHAREWARE product, but I will accept useful suggestions from ANYBODY!
  36.  
  37. The address at which to send the registration fee is:
  38.  
  39.            Rick Hillier
  40.            405 Barrington Lane
  41.            WATERLOO, Ontario
  42.            Canada     N2T 1H9
  43.  
  44.  
  45.  
  46.                                 DISCLAIMER
  47.  
  48. CATDISK is provided on an "as is" basis.  Any damages arising from the use of
  49. this program are entirely the responsibility of the user; i.e. the author, Rick
  50. Hillier, cannot be held responsible for any damages.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                               STARTING CATDISK
  70.  
  71. CATDISK may be started from the DOS command line by the following:
  72.  
  73. C>CATDISK parameters
  74.  
  75.   - where parameters may include any of the following:');
  76.  
  77.        /BW        - Supress colors for Black and White displays.
  78.                     If your display is connected to a "monochrome"
  79.                     (Text Only) adapter, then the colors will be
  80.                     automatically set; this parameter is not needed.
  81.  
  82.        /NS        - Supress status indicators during processing.
  83.                     This speeds up processing time.  Status indicators
  84.                     are there simply to indicate that the computer is
  85.                     actually doing something useful.  Try it either way
  86.                     and set it to your liking.
  87.  
  88.        /NA        - Supress ARChive filename extraction.
  89.  
  90.        /Ffilename - The default filename that CATDISK uses is "CATDISK".
  91.                     This may be overridden with this parameter.
  92.                     Note that there is no space between the /F and the
  93.                     filename.
  94.  
  95.        /D:        - Catalog files from drive D: where D: is one
  96.                     of [A,B,C,D].
  97.  
  98.   The slash "/" may be substituted by either a dash "-" or a space " ".
  99.  
  100.   Eg.  CATDISK /BW/NS/NA/B:
  101.        CATDISK A:
  102.  
  103. - entering      CATDISK ? will bring up a help message indicating the above.
  104.  
  105.  
  106. Once CATDISK has been successfully started, a title screen will appear.  Hit
  107. any key to ascend to the main menu.
  108.  
  109.  
  110.  
  111.               OPTION #1:  SETTING THE CURRENT DISK DRIVE
  112.  
  113. Option #1 from the main menu will allow you to set the drive from which the
  114. files to be catalogued will be read.  Simply select letter A,B,C or D to
  115. select the drive with that DOS letter designation.  The change will be noted
  116. immediately in the status area at the top of the screen.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                    OPTION #2:  LABELLING A DISKETTE
  137.  
  138. Selection of option #2 on the main menu will allow the VOLUME LABEL of a
  139. diskette to be set or changed.  Upon selection, CATDISK will attempt to read
  140. the current label of the diskette.  If none is present, you will be notified
  141. of this, and will be given the opportunity to create a volume label for that
  142. diskette.  See the DOS manual on volume labels for more information.  If a
  143. label already exists on the diskette, it's name will be shown as a reminder,
  144. and you will be given an opportunity to change the label name.  Just enter
  145. the new label name and hit <CR>.
  146.  
  147. If the label name was valid, the change will be made, otherwise, an error
  148. message indicating such will be issued and you will return to the main menu.
  149.  
  150. If you do not wish to enter or change the disk label, simply hit <ESC> at the
  151. volume label prompt and you will immediately return to the main menu with no
  152. changed made to the disk label.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.                    OPTION #3:  CATALOGING A DISKETTE
  159.  
  160. Selection of option #3 from the main menu will initiate cataloging of the
  161. files on the selected catalog diskette.  The volume label will be read, and
  162. if it doesn't exist, you will be given an opportunity to enter a volume label
  163. for the diskette.  Hit <ESC> to the label prompt to abort the operation.
  164.  
  165. Once the label has been found, the directory and any archive entries (if the
  166. archive option is turned on - it is by default) will be read.  Upon completion
  167. of this, the catalog summary file and master catalog will be updated to reflect
  168. the current directory of the diskette.  If any files have been added, they will
  169. be added to the catalog;  if any files have been changed, they will be updated;
  170. if any files have been deleted, they will be removed from the catalog.
  171.  
  172. Keep in mind, that deletion of an ARChive file will cause any files existing
  173. within that .ARC file to be uncatalogued.  Also, turning the Auto ARCHIVE
  174. Extraction feature OFF will cause any files in an .ARC file on that diskette
  175. to be uncatalogued as well.
  176.  
  177. This operation is completely automatic and does not require any further input
  178. from the operator once started.
  179.  
  180.  
  181.  
  182.                 OPTION #4:  UNCATALOGUING A DISKETTE
  183.  
  184. There may be times when you will wish to remove a disk's files from the
  185. catalog.  Select option #4 from the main menu, and you will be asked to enter
  186. the VOLUME NAME of the disk to be uncatalogued.  Enter it and hit <CR>.  If
  187. the volume label doesn't exist in the catalog, then you will be notified and
  188. returned to the main menu.
  189.  
  190. If the volume label is found in the catalog, it's entry will be deleted along
  191. with all the file names under it.
  192.  
  193. If you do not wish to carry out this operation, hit <Esc> at the volume label
  194. prompt and no action will be taken.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.       OPTION #5:  DISPLAYING A CATALOG SUMMARY REPORT ON THE SCREEN
  202.  
  203. Selection of option #5 from the main menu will cause CATDISK to display an
  204. alphabetical list of VOLUME NAMES and the free space on each.  You may browse
  205. through the list with <PgUp> and <PgDn>, or hit <Esc> to return to the main
  206. menu.
  207.  
  208. This option is handy if, say, you have a bunch of utility disks and want
  209. to add a 14K utility program to one of them.  This report can be quite handy
  210. in making efficient use of existing working diskettes.
  211.  
  212.  
  213.             OPTION #6:  PRINTING A CATALOG SUMMARY REPORT
  214.  
  215. Option #6 from the main menu will generate a report like that obtained on the
  216. screen from option #5.  To abort the report in mid-stream, hit <Esc> at any
  217. time throughout the report.
  218.  
  219.  
  220.            OPTION #7:  DISPLAYING SELECTED FILES ON THE SCREEN
  221.  
  222.  
  223. Selecting option #7 will cause CATDISK to display an alphabetical list of
  224. files on the screen.  Upon selection, you will be asked for a filespec.  This
  225. filespec follows the conventional DOS filespec search conventions including
  226. wildcard searches.
  227.  
  228. Eg.      *.*        - search for everything.
  229.          *.COM      - search for files ending in .COM
  230.         A*.EXE      - search for files starting with A and ending in .COM
  231.    CATDISK.COM      - search specifically for CATDISK.COM
  232.          *.?Q?      - search for files with an extension containing Q as
  233.                       it's second character.
  234.         ??.DOC      - search for files with two letters as it filename and
  235.                       .DOC as it's extension.
  236.  
  237. Please refer to the DOS manual for further information on file searching
  238. patterns.
  239.  
  240. If you do not wish to carry out this option, hit <Esc> at the filespec prompt.
  241.  
  242. Upon entering the search spec, scanning of the catalog will commence.  If you
  243. have status indicators turned on, a counter will increment each time a matching
  244. file is found.  If at the end of the search, no files were found, an error
  245. message will be issued and you will be returned to the main menu.
  246.  
  247. Upon a successful search, the file names will be shown alphabetically, along
  248. with the volume name, archive name, and other directory information for that
  249. file.  You may browse through the list with <PgUp> and <PgDn>, or return to the
  250. main menu with <Esc>.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.            OPTION #8:  PRINTING SELECTED FILES ON THE PRINTER
  269.  
  270. Selection of option #8 is identical to Option #7, except that the list is
  271. printed in paginated form on your printer.  It is assumed that the page length
  272. of your printer is 66 lines.  File information is echoed to the screen as it is
  273. sent to the printer.
  274.  
  275.  
  276.                     OPTION #9:  ALL FILES TO SCREEN
  277.  
  278. Selection of option #9 is similar to option #7, except that ALL files are shown
  279. on the screen.  It is the equivalent of searching for *.*.
  280.  
  281.  
  282.                     OPTION #0:  ALL FILES TO PRINTER
  283.  
  284. Selection of option #0 is similar to option #8, except that ALL files are
  285. printed.  It is the equivalent of searching for *.*.
  286.  
  287.  
  288.                   OPTION F1:  TOGGLE AUTO ARC EXTRACT
  289.  
  290. Although this option may be controlled from the DOS command line, it is also
  291. convenient to be able to change it during a CATDISK session.  Hitting <F1>
  292. will toggle the Auto Arc Extract Feature.  The current status is shown on
  293. near the top of the screen in the status area.
  294.  
  295. If this feature is turned off, any file searches through the catalog will
  296. NOT show any files that reside in an archive file.  The archive file's
  297. presence will still be shown in the listing.
  298.  
  299.  
  300.                       OPTION ESC:  EXIT TO DOS
  301.  
  302. Select this option when you are finished with CATDISK to terminate it's
  303. operation.
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                               SUPPORT AND UPDATES
  336.  
  337. As I said in the introduction, I will only offer advice and technical support
  338. to those who contribute via the SHAREWARE concept.  Users who do contribute
  339. will be notified when updates and new products are available.  Anyone wishing
  340. to offer advice and suggestions are most welcome to do so.
  341.  
  342. I may be reached on CompuServe at I.D. #  73307,333, or on THE PEARL BBS
  343. in WATERLOO, Ontario, Canada, under my name, Rick Hillier.
  344.  
  345. The most up to date version of CATDISK is always available on THE PEARL, which
  346. may be reached at (519)-576-6754, 24 hrs. a day.
  347.